home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / The World of Computer Software.iso / msqp22b.zip / BETA.DOC next >
Text File  |  1993-01-05  |  17KB  |  514 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.           _________________________________________________________________
  24.  
  25.           Msgedsq 2.2b Beta notes.                       Released 05/01/93.
  26.           Copyright (c) 1993 John Dennis.              All rights reserved.
  27.           _________________________________________________________________
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.           ───────────────────────────────────────────────────────────────
  65.           Msgedsq Beta Documentation                              Page 1
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.                                    C O N T E N T S
  74.  
  75.           Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   3
  76.  
  77.           Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . .   3
  78.  
  79.           Reader Changes  . . . . . . . . . . . . . . . . . . . . . . .   4
  80.  
  81.           Editor Changes  . . . . . . . . . . . . . . . . . . . . . . .   4
  82.  
  83.           Configuration File Changes  . . . . . . . . . . . . . . . . .   5
  84.  
  85.           New Bits  . . . . . . . . . . . . . . . . . . . . . . . . . .   6
  86.  
  87.           Templates . . . . . . . . . . . . . . . . . . . . . . . . . .   7
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.           ───────────────────────────────────────────────────────────────
  129.           Msgedsq Beta Documentation                              Page 2
  130.  
  131.  
  132.  
  133.  
  134.           ┌─────────────────┐
  135.           │ Introduction    │
  136.           └─────────────────┘
  137.  
  138.           Hi... It's finally here.  Thanks to all those people who
  139.           supported me & kept up the reports even though there wasn't a new
  140.           version in sight.  It wasn't going to take this long - but once I
  141.           got started I couldn't stop.
  142.  
  143.           This file details (?) most of the new stuff you have to worry
  144.           about in the 2.2b version of Msgedsq.  There have been *major*
  145.           changes throughout the entire program, so I feel it is necessary
  146.           to "wide beta" this for a while.  The "conversion" is not yet
  147.           complete:  some of the functions have yet to be "windowized", so
  148.           I will continue to make additions and release a non-beta version
  149.           when ready.  Send all bug reports to me at: 
  150.  
  151.           Fidonet : 3:690/668
  152.           Internet: john@miyu.DIALix.oz.au
  153.  
  154.           The international MSGED_ECHO and TUB echomail areas are also ok
  155.           to send reports.  Please don't use MUFFIN because a) it already
  156.           has heaps of traffic, and b) I don't read it anymore.
  157.  
  158.           Please do not try to call my node; it is a Mail-Only node and
  159.           only available during the national zone mail hour.  This will
  160.           change in the future, but when is a different question.  If
  161.           you've sent me mail via an Internet gate before and never got a
  162.           reply: then it's likely my reply bounced.  This happens at an
  163.           alarming rate.
  164.  
  165.  
  166.           ┌──────────┐
  167.           │  Notes   │
  168.           └──────────┘
  169.  
  170.           The documentation "proper" has not been updated yet (and won't be
  171.           until the non-beta version).  Some features still have not been
  172.           re-implemented in this version, including the setting of the
  173.           cursor size and bios writes to the screen.  There also isn't a
  174.           colour set for monochrome screens.  If someone could set one up,
  175.           will will be included in the final release.
  176.  
  177.           If you're new to this program, the full (outdated) documentation
  178.           is available in previous versions that may (or may not) be
  179.           floating about the place.  Most of the setup should be obvious,
  180.           but if you have trouble please refer to an older version.
  181.  
  182.           Since it's quite possible that I have forgotten to put bits in
  183.           here, please use the DISTRIBUTED config file.  Your old one (if
  184.           you have one) WILL NOT WORK!  I cannot reinforce this enough. 
  185.           Msgedsq has never had much config syntax checking and probably
  186.           never will, so any errors will probably be on your part...
  187.  
  188.  
  189.  
  190.  
  191.  
  192.           ───────────────────────────────────────────────────────────────
  193.           Msgedsq Beta Documentation                              Page 3
  194.  
  195.  
  196.  
  197.  
  198.           ┌────────────────┐
  199.           │ Reader Changes │
  200.           └────────────────┘
  201.  
  202.           o    Much of the main message sub-system has been changed.  This
  203.                should eliminate most message creation problems (like
  204.                creating a message in an empty fido area).
  205.  
  206.           o    V7 Support has been fixed.
  207.  
  208.           o    Macros work in almost all areas except inside entry fields
  209.                (in the header and dialog boxes).  They will work in all
  210.                other areas, but please note that templates can be used now
  211.                for message entry (sigs and the like).
  212.  
  213.           o    Support for UUCP has been improved in areas (tho it still
  214.                has a way to go).  It now ignores the date in Internet
  215.                messages to avoid those traps in OS/2 (the UUCP gate usually
  216.                attempts to parse them anyway).
  217.  
  218.           o    Massive changes to the display system.  Every bit of code
  219.                that writes to the screen and talks to the user has been
  220.                rewritten.  There are now windows/dialog boxes and much more
  221.                to boot.  Even better: now that this sub-system is in place
  222.                I can use it to do some pretty fancy things.
  223.  
  224.           o    The way it reads addresses has been changed.  It doesn't
  225.                rely on ^aMSIGDs and ^aREPLYs anymore, and as a result, the
  226.                address should more correctly reflect what it should be. 
  227.                You also won't have trouble changing addresses anymore :-)
  228.  
  229.           o    The find bug has been removed.  It shouldn't trap any
  230.                longer...  It also now highlights the line of text in which
  231.                the text was found (if it was in the message text).
  232.  
  233.           o    The menu sub-system has been re-written to add mouse support
  234.                and a little more flexibility.
  235.  
  236.           o    The scanned bit is also shown for squish message bases.
  237.  
  238.           o    Addressing has been fixed as best as this author knows how
  239.                (with advice from a very helpful david nugent).  Addresses
  240.                should now show up as they are, rather than being a copy of
  241.                what was in ^aMSGIDs and ^aREPLYs.  Addressing information
  242.                is now obtained in an order of importance corresponding to
  243.                the kind of information obtained.
  244.  
  245.           o    Many other numerous bug fixes.
  246.  
  247.  
  248.           ┌─────────────────┐
  249.           │ Editor Changes  │
  250.           └─────────────────┘
  251.  
  252.           o    The editor has been re-built from the ground up.  It
  253.                functions in the same manner but is different internally in
  254.                the way it displays, wraps and other general text handling
  255.  
  256.           ───────────────────────────────────────────────────────────────
  257.           Msgedsq Beta Documentation                              Page 4
  258.  
  259.  
  260.  
  261.  
  262.                operations. It should now be possible to wrap other
  263.                character sets (Russian etc etc).
  264.  
  265.           o    The whole thing should be more predictable and look better
  266.                when wrapping (not so much jumping around).
  267.  
  268.           o    The pause bug is dead.
  269.  
  270.           o    Qedit-like blocking (without the follow-me cursor bit).  You
  271.                can use the block key to resize the block and generally
  272.                stuff around until you're satisfied with the block.  The cut
  273.                and paste operations work in the same manner, however.  An
  274.                "unblock" function has been added to deselect the current
  275.                block.  
  276.  
  277.           o    You can decide what you want to export - the message, the
  278.                currently selected block, or the clipboard, depending on
  279.                what is there.
  280.  
  281.           o    Template support is integrated with template lines showing
  282.                up as a different colour (configurable).  The action of
  283.                chopping the end off quotes is also now configurable (see
  284.                the "chopquote" switch).
  285.  
  286.  
  287.           ┌───────────────────────────────┐
  288.           │ Configuration File Changes    │
  289.           └───────────────────────────────┘
  290.  
  291.           o    All of the parsing routines have been re-written, with a
  292.                common set of functions providing parsing functionality for
  293.                all config files.
  294.  
  295.           o    The switch format has changed; switches may be set on or off
  296.                in the configuration file.  The default settings along with
  297.                all available switches are listed in the configuration file.
  298.  
  299.           o    Colours are of course configurable, but the syntax has
  300.                changed, as has the available colours.  See the msq.col file
  301.                for instructions.
  302.  
  303.           o    There are many new switches... Some have been waiting to be
  304.                added for a long time - please check them out.
  305.  
  306.           o    You can now specify the UUCP gate name (so you can use
  307.                "FredGate" or similar).  See the "UucpName" config verb in
  308.                the config file.
  309.  
  310.           o    The format of aliases has changed; you can now specify an
  311.                attribute for that message (doesn't apply to use in CC:'s). 
  312.                You CANNOT use your old configuration file aliases... You
  313.                will have to convert them - see the distributed config file
  314.                for the format.  It should be pretty obvious.
  315.  
  316.           o    The format for message area definition has changed! The
  317.                changes are relatively simple: the area type (uucp, netmail,
  318.                echomail etc.) has been combined with the switches to form
  319.  
  320.           ───────────────────────────────────────────────────────────────
  321.           Msgedsq Beta Documentation                              Page 5
  322.  
  323.  
  324.  
  325.  
  326.                one block of characters.
  327.  
  328.                u = uucp                           e = echomail
  329.                n = news                           m = netmail
  330.                l = local                          h = hold
  331.                p = private                        k = kill/sent
  332.                c = crash                          d = direct
  333.  
  334.           o    Blind CC:'s are now supported; The message only (minus the
  335.                cc: text) sent to the recipients.  Use "bc:" to activate
  336.                this feature.
  337.  
  338.           o    Verbose CC:'s are also supported.  The full address of every
  339.                person is given rather than just the name. Use "vc:" instead
  340.                of "cc:" to activate this feature.
  341.  
  342.           o    Response files are also now supported when entering CC:s (of
  343.                any kind).  There can only be one response file per CC: line
  344.                - and it must be the first item on the line, for example:
  345.  
  346.                cc: ~beta.rsp
  347.  
  348.                Any other information on the line will be ignored.  The
  349.                format of the file is exactly the same as that used on CC:
  350.                lines, except that there may only be one destination per
  351.                line. Comments are delimited by a ';'.  NOTE: you can use
  352.                blind, normal and verbose CC:s with this feature.
  353.  
  354.           o    Templates have replaced the use of the old attribution
  355.                lines.  See the distributed template for documentation on
  356.                it's use. (There is also a section in here describing them).
  357.  
  358.  
  359.           ┌───────────┐
  360.           │ New Bits  │
  361.           └───────────┘
  362.  
  363.           The most obvious change is the look & feel.  All keypresses are
  364.           exactly the same as before.  When in reader mode there are a
  365.           number of hotspots, or active screen portions, these are:
  366.  
  367.           bottom 2 lines     :     This will respond to a down-press of the
  368.                                    left mouse button, and will go down the
  369.                                    message until you release the button.
  370.  
  371.           top 2 lines        :     Same as above, but will go up the
  372.                                    message.
  373.  
  374.           Left & Right sides :     These will move left and right one
  375.                                    message if a left click is received, or
  376.                                    continuously move through messages until
  377.                                    the left button is released.
  378.  
  379.           Note, the above top and side HotSpots are relative to the message
  380.           text portion of the display (that is, underneath the text/header
  381.           divider line).
  382.  
  383.  
  384.           ───────────────────────────────────────────────────────────────
  385.           Msgedsq Beta Documentation                              Page 6
  386.  
  387.  
  388.  
  389.  
  390.           Link Arrows        :     This responds to clicks of the left
  391.                                    mouse button only, and will go to the
  392.                                    indicated linked message.  If there is
  393.                                    more than one link in that direction
  394.                                    (indicated by two arrows), a menu (also
  395.                                    mouse operated, see below) will appear
  396.                                    so a choice can be made.
  397.  
  398.           Pop-Up menus       :     Pop-Up menus are simply selection boxes; 
  399.                                    any mouse button release on a menu item
  400.                                    will choose that item, any mouse press
  401.                                    above the top-most item or below the
  402.                                    lowest item will cause scrolling in that
  403.                                    direction.  Also responds to continued
  404.                                    pressing (ie "dragging" of selection
  405.                                    bar).
  406.  
  407.           DialogBoxes        :     Dialog boxes are characterized by
  408.                                    buttons (in this app, anyway) and will
  409.                                    also include edit-fields and check-
  410.                                    boxes.  Generally, navigation is the
  411.                                    same as SAA/CUA compliant interfaces,
  412.                                    including keyboard navigation (but it's
  413.                                    not perfect yet :-)
  414.  
  415.           Menus              :     There are menus, but currently they
  416.                                    aren't pull-down - only the menu-bar
  417.                                    options are in use.  These can be seen
  418.                                    on the top right hand corner of the
  419.                                    screen. Selection occurs on mouse button
  420.                                    release.
  421.  
  422.  
  423.           ┌───────────┐
  424.           │ Templates │
  425.           └───────────┘
  426.  
  427.           Some of the other changes include a re-vamped quoting system;  a
  428.           template file is now used for everything including forwarding and
  429.           redirection of messages.  The template file replaces attribution
  430.           lines of all kinds (so you can remove them from the config file),
  431.           but does not replace the function definition section (which is
  432.           optional anyway).  See the template file for info on how it
  433.           works.
  434.  
  435.           One of the nice things about a template is that you can put in a
  436.           sig that will be appended for all new (quoted & otherwise)
  437.           messages.  One of the problems is that the old way of getting rid
  438.           of spurious quote lines becomes a little more difficult; 
  439.           template lines are now specially marked in the editor - if you
  440.           change one in any way it becomes a normal line of text.  
  441.  
  442.           The benefit of marking them thus is that Msgedsq will first
  443.           search for the last line of text (!quote && !blank && !template)
  444.           and will then search for the NEXT template line.  If found, ALL
  445.           lines in between will be deleted, so you can quite easily specify
  446.           the *exact* look for you messages (how many lines between the
  447.  
  448.           ───────────────────────────────────────────────────────────────
  449.           Msgedsq Beta Documentation                              Page 7
  450.  
  451.  
  452.  
  453.  
  454.           text, sig and origin line).  Again, see the template file for an
  455.           example.
  456.  
  457.           End of Document.
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.  
  468.  
  469.  
  470.  
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.           ───────────────────────────────────────────────────────────────
  513.           Msgedsq Beta Documentation                              Page 8
  514.